IRIX Base Documentation 2002 November/SGI IRIX Base Documentation 2002 November.iso/usr/share/catman/p_man/cat3/Xm/XmText.z/XmText

Text File | 2002-10-03 | 242.2 KB | 3,565 lines

     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



     NNNNAAAAMMMMEEEE
          XXXXmmmmTTTTeeeexxxxtttt - The Text widget class

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
          #include <Xm/Text.h>

     VVVVEEEERRRRSSSSIIIIOOOONNNN
          This page documents Motif 2.1.

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
          Text provides a single-line and multiline text editor for
          customizing both user and programmatic interfaces. It can be
          used for single-line string entry, forms entry with
          verification procedures, and full-window editing.  It
          provides an application with a consistent editing system for
          textual data. The screen's textual data adjusts to the
          application writer's needs.

          Text provides separate callback lists to verify movement of
          the insert cursor, modification of the text, and changes in
          input focus. Each of these callbacks provides the
          verification function with the widget instance, the event
          that caused the callback, and a data structure specific to
          the verification type. From this information, the function
          can verify if the application considers this to be a
          legitimate state change and can signal the widget whether to
          continue with the action.

          The user interface tailors a new set of translations. The
          default translations provide key bindings for insert cursor
          movement, deletion, insertion, and selection of text.

          Text allows the user to select regions of text.  Selection
          is based on the model specified in the _I_n_t_e_r-_C_l_i_e_n_t
          _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l (ICCCM). Text supports
          primary and secondary selection.

          In some Asian languages, texts are drawn vertically. Also,
          some characters are displayed with 90-degree clockwise
          rotation, and other characters are mapped to vertical glyphs
          that differ from the normal horizaontal glyphs.  Information
          about which characters require rotation or mapping to
          vertical glyphs is specified in the X Locale Database (NLS
          databases) and handled by X library, depending on
          XXXXNNNNOOOOrrrriiiieeeennnnttttaaaattttiiiioooonnnn XXXXOOOOCCCC values.  _X_m_T_e_x_t widget should also handle
          the vertically aligned lines as for editing, entering, or
          selecting texts.

          The vertical writing feature of the _X_m_T_e_x_t widget is enabled
          when the _X_m_T_O_P__T_O__B_O_T_T_O_M value is specified for the
          _X_m_N_l_a_y_o_u_t_D_i_r_e_c_t_i_o_nresource of the _X_m_T_e_x_t widget. In that
          case, the horizontal scroll bar is displayed on the bottom



     Page 1                                          (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



          of the _X_m_T_e_x_t widget and the vertical scroll bar is
          displayed on the left side.

        MMMMoooouuuusssseeee SSSSeeeelllleeeeccccttttiiiioooonnnn
          The Text widget allows text to be edited, inserted, and
          selected.  The user can cut, copy, and paste text by using
          the clipboard, primary transfer, or secondary transfer.
          Text also provides a Drag and Drop facility that enables the
          user to copy or move data within Text or to a different
          widget.  When keyboard focus policy is set to EXPLICIT, the
          widget that receives focus is the destination widget. In
          POINTER mode, any keyboard or mouse operation (except
          secondary selection) in an editable widget establishes that
          widget as the destination.

          If a destination widget becomes insensitive or uneditable,
          it forfeits its destination status. In EXPLICIT mode, when a
          widget becomes insensitive, the focus moves to another
          widget. If that widget is editable, it becomes the
          destination widget; otherwise, there is no destination
          widget. The text of any insensitive Text widget is stippled,
          indicating its state to the user.

          The insertion cursor, displayed as an I-beam, shows where
          input is inserted. Input is inserted just before the
          insertion cursor.

          Text uses the _X_m_Q_T_n_a_v_i_g_a_t_o_r, _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e, and
          _X_m_Q_T_s_c_r_o_l_l_F_r_a_m_e traits, and holds the _X_m_Q_T_a_c_c_e_s_s_T_e_x_t_u_a_land
          _X_m_Q_T_t_r_a_n_s_f_e_r traits.  The widget checks its parent for the
          _X_m_Q_T_s_c_r_o_l_l_F_r_a_m_e trait. If this trait does not exist, then
          the widget has no scrolling. If the trait does exist, and
          the ScrollFrame widget has not been initialized, the widget
          creates two navigators and sets up the scrollbars.

          If an application or widget calls the sssseeeettttVVVVaaaalllluuuueeee trait method
          of _X_m_Q_T_a_c_c_e_s_s_T_e_x_t_u_a_l, then XXXXmmmmTTTTeeeexxxxtttt will call XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttSSSSttttrrrriiiinnnngggg
          to set the string value.

        CCCCllllaaaasssssssseeeessss
          Text inherits behavior, resources, and traits from CCCCoooorrrreeee and
          XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee.

          The class pointer is _x_m_T_e_x_t_W_i_d_g_e_t_C_l_a_s_s.

          The class name is XXXXmmmmTTTTeeeexxxxtttt.

        DDDDaaaattttaaaa TTTTrrrraaaannnnssssffffeeeerrrr BBBBeeeehhhhaaaavvvviiiioooorrrr
          Text supports transfer of the primary, secondary, and
          clipboard selections and dragging of selected text from the
          widget.  Text can also be the destination for the primary,
          secondary, and clipboard selections, and it supports



     Page 2                                          (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



          dropping of data being dragged onto the widget.

          When the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures are called, the
          llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa member of the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt member
          is NULL if the selected text is being transferred.  If the
          entire text, not the selected text, is being transferred,
          the value of this member is the widget ID of the Text
          widget.

          As a source of data, Text supports the following targets and
          associated conversions of data to these targets:

          _l_o_c_a_l_e    If the _l_o_c_a_l_e target matches the widget's locale,
                    the widget transfers the selected text in the
                    encoding of the locale.

          _C_O_M_P_O_U_N_D__T_E_X_T
                    The widget transfers the selected text as type
                    _C_O_M_P_O_U_N_D__T_E_X_T.

          _S_T_R_I_N_G    The widget transfers the selected text as type
                    _S_T_R_I_N_G.

          _T_E_X_T      If the selected text is fully convertible to the
                    encoding of the locale, the widget transfers the
                    selected text in the encoding of the locale.
                    Otherwise, the widget transfers the selected text
                    as type _C_O_M_P_O_U_N_D__T_E_X_T.

          _D_E_L_E_T_E    The widget deletes the selected text.

          ____MMMMOOOOTTTTIIIIFFFF____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS
                    The widget transfers, as type _A_T_O_M, a list of the
                    targets to which the widget can convert data to be
                    placed on the clipboard immediately.  If the
                    selected text is fully convertible to _S_T_R_I_N_G,
                    these include _S_T_R_I_N_G; otherwise, they include
                    _C_O_M_P_O_U_N_D__T_E_X_T.

          ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFEEEERRRRRRRREEEEDDDD____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS
                    The widget transfers, as type _A_T_O_M, a list of the
                    targets it supports for delayed transfer for the
                    _C_L_I_P_B_O_A_R_D selection.  This widget currently
                    supplies no targets for
                    ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFEEEERRRRRRRREEEEDDDD____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS.

          ____MMMMOOOOTTTTIIIIFFFF____EEEEXXXXPPPPOOOORRRRTTTT____TTTTAAAARRRRGGGGEEEETTTTSSSS
                    The widget transfers, as type _A_T_O_M, a list of the
                    targets to be used as the value of the
                    DragContext's XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss in a drag-and-drop
                    transfer.  These include _C_O_M_P_O_U_N_D__T_E_X_T, the
                    encoding of the locale, _S_T_R_I_N_G, _T_E_X_T, _B_A_C_K_G_R_O_U_N_D,



     Page 3                                          (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    and _F_O_R_E_G_R_O_U_N_D.

          ____MMMMOOOOTTTTIIIIFFFF____LLLLOOOOSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN
                    The widget takes the following actions:

                       +o  When losing the _P_R_I_M_A_R_Y selection, it
                          unhighlights the selected text and calls the
                          XXXXmmmmNNNNlllloooosssseeeePPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.

                       +o  When losing the _S_E_C_O_N_D_A_R_Y selection, it
                          removes the secondary selection highlight.

                       +o  When losing the ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEESSSSTTTTIIIINNNNAAAATTTTIIIIOOOONNNN
                          selection, if the widget does not have
                          focus, it changes the cursor to indicate
                          that the widget is no longer the
                          destination.

          As a source of data, Text also supports the following
          standard Motif targets:

          _B_A_C_K_G_R_O_U_N_D
                    The widget transfers XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnndddd as type _P_I_X_E_L.

          _C_L_A_S_S     The widget finds the first shell in the widget
                    hierarchy that has a WWWWMMMM____CCCCLLLLAAAASSSSSSSS property and
                    transfers the contents as text in the current
                    locale.

          _C_L_I_E_N_T__W_I_N_D_O_W
                    The widget finds the first shell in the widget
                    hierarchy and transfers its window as type _W_I_N_D_O_W.

          _C_O_L_O_R_M_A_P  The widget transfers XXXXmmmmNNNNccccoooolllloooorrrrmmmmaaaapppp as type _C_O_L_O_R_M_A_P.

          _F_O_R_E_G_R_O_U_N_D
                    The widget transfers XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnndddd as type _P_I_X_E_L.

          _N_A_M_E      The widget finds the first shell in the widget
                    hierarchy that has a WWWWMMMM____NNNNAAAAMMMMEEEE property and
                    transfers the contents as text in the current
                    locale.

          _T_A_R_G_E_T_S   The widget transfers, as type _A_T_O_M, a list of the
                    targets it supports.  These include the standard
                    targets in this list.  These also include
                    _C_O_M_P_O_U_N_D__T_E_X_T, the encoding of the locale, _S_T_R_I_N_G,
                    and _T_E_X_T.

          _T_I_M_E_S_T_A_M_P The widget transfers the timestamp used to acquire
                    the selection as type _I_N_T_E_G_E_R.




     Page 4                                          (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



          ____MMMMOOOOTTTTIIIIFFFF____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE
                    The widget transfers XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee if it exists,
                    or else the default text render table, as type
                    _S_T_R_I_N_G.

          ____MMMMOOOOTTTTIIIIFFFF____EEEENNNNCCCCOOOODDDDIIIINNNNGGGG____RRRREEEEGGGGIIIISSSSTTTTRRRRYYYY
                    The widget transfers its encoding registry as type
                    _S_T_R_I_N_G.  The value is a list of NULL separated
                    items in the form of tag encoding pairs.  This
                    target symbolizes the transfer target for the
                    Motif Segment Encoding Registry.  Widgets and
                    applications can use this Registry to register
                    text encoding formats for specified render table
                    tags.  Applications access this Registry by
                    calling XXXXmmmmRRRReeeeggggiiiisssstttteeeerrrrSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg and
                    XXXXmmmmMMMMaaaappppSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg.

          As a destination for data, Text chooses a target and
          requests conversion of the selection to that target.  If the
          encoding of the locale is present in the list of available
          targets, Text chooses a requested target from the available
          targets in the following order of preference:

             1. The encoding of the locale

             2. _T_E_X_T

             3. _C_O_M_P_O_U_N_D__T_E_X_T

             4. _S_T_R_I_N_G

          If the encoding of the locale is not present in the list of
          available targets, Text chooses a requested target from the
          available targets in the following order of preference:

             1. _C_O_M_P_O_U_N_D__T_E_X_T

             2. _S_T_R_I_N_G

        NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
          The following table defines a set of widget resources used
          by the programmer to specify data. The programmer can also
          set the resource values for the inherited classes to set
          attributes for this widget. To reference a resource by name
          or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
          prefix and use the remaining letters. To specify one of the
          defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove
          the XXXXmmmm prefix and use the remaining letters (in either
          lowercase or uppercase, but include any underscores between
          words).  The codes in the access column indicate if the
          given resource can be set at creation time (C), set by using
          XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is



     Page 5                                          (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



          not applicable (N/A).
                                                   XXXXmmmmTTTTeeeexxxxtttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
          NNNNaaaammmmeeee                         CCCCllllaaaassssssss                       TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt              AAAAcccccccceeeessssssss
          XmNactivateCallback          XmCCallback                 XtCallbackList   NULL                 C
          XmNautoShowCursorPosition    XmCAutoShowCursorPosition   Boolean          True                 CSG
          XmNcursorPosition            XmCCursorPosition           XmTextPosition   0                    CSG
          XmNcursorPositionVisible     XmCCursorPositionVisible    Boolean          dynamic              CSG
          XmNdestinationCallback       XmCCallback                 XtCallbackList   NULL                 C
          XmNeditable                  XmCEditable                 Boolean          True                 CSG
          XmNeditMode                  XmCEditMode                 int              XmSINGLE_LINE_EDIT   CSG
          XmNfocusCallback             XmCCallback                 XtCallbackList   NULL                 C
          XmNgainPrimaryCallback       XmCCallback                 XtCallbackList   NULL                 C
          XmNlosePrimaryCallback       XmCCallback                 XtCallbackList   NULL                 C
          XmNlosingFocusCallback       XmCCallback                 XtCallbackList   NULL                 C
          XmNmarginHeight              XmCMarginHeight             Dimension        5                    CSG
          XmNmarginWidth               XmCMarginWidth              Dimension        5                    CSG
          XmNmaxLength                 XmCMaxLength                int              largest integer      CSG
          XmNmodifyVerifyCallback      XmCCallback                 XtCallbackList   NULL                 C
          XmNmodifyVerifyCallbackWcs   XmCCallback                 XtCallbackList   NULL                 C
          XmNmotionVerifyCallback      XmCCallback                 XtCallbackList   NULL                 C
          XmtotalLines                 XmCTotalLines               int              dynamic              C
          XmNsource                    XmCSource                   XmTextSource     Default source       CSG
          XmNtopCharacter              XmCTopCharacter             XmTextPosition   0                    CSG
          XmNvalue                     XmCValue                    String           ""                   CSG
          XmNvalueChangedCallback      XmCCallback                 XtCallbackList   NULL                 C
          XmNvalueWcs                  XmCvalueWcs                 wchar_t *        (wchar_t *)""        CSG1
          XmNverifyBell                XmCVerifyBell               Boolean          dynamic              CSG

          1 This resource cannot be set in a resource file.

          XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies the list of callbacks that is called
                    when the user invokes an event that calls the
                    activate() action.  The type of the structure
                    whose address is passed to this callback is
                    XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent by the
                    callback is XXXXmmmmCCCCRRRR____AAAACCCCTTTTIIIIVVVVAAAATTTTEEEE.

          XXXXmmmmNNNNaaaauuuuttttooooSSSShhhhoooowwwwCCCCuuuurrrrssssoooorrrrPPPPoooossssiiiittttiiiioooonnnn
                    Ensures that the visible text contains the insert
                    cursor when set to True.  If the insert cursor
                    changes, the contents of Text may scroll in order
                    to bring the insertion point into the window.
                    Setting this resource to False, however, does not
                    ensure that Text will not scroll.

          XXXXmmmmNNNNccccuuuurrrrssssoooorrrrPPPPoooossssiiiittttiiiioooonnnn
                    Indicates the position in the text where the
                    current insert cursor is to be located.  Position
                    is determined by the number of characters from the
                    beginning of the text.  The first character
                    position is 0 (zero).



     Page 6                                          (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



          XXXXmmmmNNNNccccuuuurrrrssssoooorrrrPPPPoooossssiiiittttiiiioooonnnnVVVViiiissssiiiibbbblllleeee
                    If the widget has an _X_m_P_r_i_n_t_S_h_e_l_l as one of its
                    ancestors, then the default value is FFFFaaaallllsssseeee;
                    otherwise, it is TTTTrrrruuuueeee.

          XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies a list of callbacks called when the
                    widget is the destination of a transfer operation.
                    The type of the structure whose address is passed
                    to these callbacks is XXXXmmmmDDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.
                    The reason is XXXXmmmmCCCCRRRR____OOOOKKKK.

          XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee
                    When set to True, indicates that the user can edit
                    the text string.  Prohibits the user from editing
                    the text when set to False.

                    When XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee is used on a widget it sets the
                    dropsite to XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____AAAACCCCTTTTIIIIVVVVEEEE.

          XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee
                    Specifies the set of keyboard bindings used in
                    Text.  The default, XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, provides
                    the set of key bindings to be used in editing
                    single-line text.  XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT provides the
                    set of key bindings to be used in editing
                    multiline text.

                    The results of placing a Text widget inside a
                    ScrolledWindow when the Text's XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is
                    XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT are undefined.

          XXXXmmmmNNNNffffooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies the list of callbacks called when Text
                    accepts input focus. The type of the structure
                    whose address is passed to this callback is
                    XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent by the
                    callback is XXXXmmmmCCCCRRRR____FFFFOOOOCCCCUUUUSSSS.

          XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies the list of callbacks called when an
                    event causes the Text widget to gain ownership of
                    the primary selection.  The reason sent by the
                    callback is XXXXmmmmCCCCRRRR____GGGGAAAAIIIINNNN____PPPPRRRRIIIIMMMMAAAARRRRYYYY.

          XXXXmmmmNNNNlllloooosssseeeePPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies the list of callbacks called when an
                    event causes the Text widget to lose ownership of
                    the primary selection.  The reason sent by the
                    callback is XXXXmmmmCCCCRRRR____LLLLOOOOSSSSEEEE____PPPPRRRRIIIIMMMMAAAARRRRYYYY.

          XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk



     Page 7                                          (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    Specifies the list of callbacks called before Text
                    loses input focus.  The type of the structure
                    whose address is passed to this callback is
                    XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent by
                    the callback is XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS.

          XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt
                    Specifies the distance between the top edge of the
                    widget window and the text, and between the bottom
                    edge of the widget window and the text.

          XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh
                    Specifies the distance between the left edge of
                    the widget window and the text, and between the
                    right edge of the widget window and the text.

          XXXXmmmmNNNNmmmmaaaaxxxxLLLLeeeennnnggggtttthhhh
                    Specifies the maximum length of the text string
                    that can be entered into text from the keyboard.
                    This value must be nonnegative.  Strings that are
                    entered by using the XXXXmmmmNNNNvvvvaaaalllluuuueeee resource or the
                    XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttSSSSttttrrrriiiinnnngggg function ignore this resource.

          XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies the list of callbacks called before text
                    is deleted from or inserted into Text.  The type
                    of the structure whose address is passed to this
                    callback is XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The
                    reason sent by the callback is
                    XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE.  When multiple Text
                    widgets share the same source, only the widget
                    that initiates the source change will generate
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk.

                    If both XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk and
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssssare registered callback
                    lists, the procedure(s) in the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk list is always executed
                    first; and the resulting data, which may have been
                    modified, is passed to the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss callback routines.

          XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss
                    Specifies the list of callbacks called before text
                    is deleted from or inserted into Text. The type of
                    the structure whose address is passed to this
                    callback is XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttWWWWccccssss. The
                    reason sent by the callback is
                    XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE.  When multiple Text
                    widgets share the same source, only the widget
                    that initiates the source change will generate the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss.



     Page 8                                          (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    If both XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk and
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssssare registered callback
                    lists, the procedure(s) in the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk list is always executed
                    first; and the resulting data, which may have been
                    modified, is passed to the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss callback routines.

          XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies the list of callbacks called before the
                    insert cursor is moved to a new position.  The
                    type of the structure whose address is passed to
                    this callback is XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The
                    reason sent by the callback is
                    XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  It is possible for
                    more than one XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk to be
                    generated from a single action.

          XXXXmmmmNNNNssssoooouuuurrrrcccceeee Specifies the source with which the widget
                    displays text.  If no source is specified, the
                    widget creates a default string source.  This
                    resource can be used to share text sources between
                    Text widgets.

          XXXXmmmmNNNNttttooooppppCCCChhhhaaaarrrraaaacccctttteeeerrrr
                    Displays the position of text at the top of the
                    window.  Position is determined by the number of
                    characters from the beginning of the text.  The
                    first character position is 0 (zero).

                    If the XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, the line
                    of text that contains the top character is
                    displayed at the top of the widget without
                    shifting the text left or right.  XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss for
                    XXXXmmmmNNNNttttooooppppCCCChhhhaaaarrrraaaacccctttteeeerrrr returns the position of the first
                    character in the line that is displayed at the top
                    of the widget.

          XXXXmmmmNNNNttttoooottttaaaallllLLLLiiiinnnneeeessss
                    Indicates the number of lines in the text widget
                    buffer (not necessarily visible). The initial
                    value 1 means the text buffer is empty. The number
                    of lines reported takes into account the wwwwoooorrrrddddWWWWrrrraaaapppp
                    policy (that is, it's not simply the number of
                    newline characters.

          XXXXmmmmNNNNvvvvaaaalllluuuueeee  Specifies the string value of the Text widget as a
                    cccchhhhaaaarrrr****data value.  Moves the cursor to position 0
                    unless a value of XXXXmmmmNNNNccccuuuurrrrssssoooorrrrPPPPoooossssiiiittttiiiioooonnnn was explicitly
                    supplied in the argument list.  If XXXXmmmmNNNNvvvvaaaalllluuuueeee and
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss are both defined, the value of
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss supersedes that of XXXXmmmmNNNNvvvvaaaalllluuuueeee.



     Page 9                                          (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss returns a copy of the value of the
                    internal buffer and XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss copies the string
                    values into the internal buffer.

          XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies the list of callbacks called after text
                    is deleted from or inserted into Text.  The type
                    of the structure whose address is passed to this
                    callback is XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent
                    by the callback is XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.  When
                    multiple Text widgets share the same source, only
                    the widget that initiates the source change will
                    generate the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk. This
                    callback represents a change in the source in the
                    Text, not in the Text widget. The
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk should occur only in pairs
                    with an XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk, assuming that the
                    _d_o_i_tflag in the callback structure of the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk is not set to False.

          XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss
                    Specifies the string value of the Text widget as a
                    wwwwcccchhhhaaaarrrr____tttt**** data value.  Moves the cursor to position
                    0 unless a value of XXXXmmmmNNNNccccuuuurrrrssssoooorrrrPPPPoooossssiiiittttiiiioooonnnn was
                    explicitly supplied in the argument list.

                    This resource cannot be specified in a resource
                    file.

                    If XXXXmmmmNNNNvvvvaaaalllluuuueeee and XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss are both defined, the
                    value of XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss supersedes that of XXXXmmmmNNNNvvvvaaaalllluuuueeee.
                    XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss returns a copy of the value of the
                    internal buffer encoded as a wide character
                    string. XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss copies the value of the wide
                    character string into the internal buffer.

          XXXXmmmmNNNNvvvveeeerrrriiiiffffyyyyBBBBeeeellllllll
                    Specifies whether the bell should sound when the
                    verification returns without continuing the
                    action.  The default depends on the value of the
                    ancestor VendorShell's XXXXmmmmNNNNaaaauuuuddddiiiibbbblllleeeeWWWWaaaarrrrnnnniiiinnnngggg resource.
                                                 XXXXmmmmTTTTeeeexxxxtttt IIIInnnnppppuuuutttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
                    NNNNaaaammmmeeee                     CCCCllllaaaassssssss                    TTTTyyyyppppeeee        DDDDeeeeffffaaaauuuulllltttt         AAAAcccccccceeeessssssss
                    XmNpendingDelete         XmCPendingDelete         Boolean     True            CSG
                    XmNselectionArray        XmCSelectionArray        XtPointer   default array   CSG
                    XmNselectionArrayCount   XmCSelectionArrayCount   int         4               CSG
                    XmNselectThreshold       XmCSelectThreshold       int         5               CSG

          XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee
                    Indicates that pending delete mode is on when the
                    Boolean value is True.  Pending deletion is
                    defined as deletion of the selected text when an



     Page 10                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    insertion is made.

          XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyy
                    Defines the actions for multiple mouse clicks. The
                    value of the resource is an array of
                    XXXXmmmmTTTTeeeexxxxttttSSSSccccaaaannnnTTTTyyyyppppeeee elements.  XXXXmmmmTTTTeeeexxxxttttSSSSccccaaaannnnTTTTyyyyppppeeee is an
                    enumeration indicating possible actions.  Each
                    mouse click performed within some time of the
                    previous mouse click increments the index into
                    this array and performs the defined action for
                    that index. (This "multiclick" time is specified
                    by the operating environment, and varies among
                    different systems. In general, it is usually set
                    to some fraction of a second.) The possible
                    actions in the order they occur in the default
                    array are as follows:

                       3. XXXXmmmmSSSSEEEELLLLEEEECCCCTTTT____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN, which resets the insert
                          cursor position.

                       4. XXXXmmmmSSSSEEEELLLLEEEECCCCTTTT____WWWWOOOORRRRDDDD, which selects a word.

                       5. XXXXmmmmSSSSEEEELLLLEEEECCCCTTTT____LLLLIIIINNNNEEEE, which selects a line of text.
                          This action sees a line as delimited by _h_a_r_d
                          newline characters. In other words, if the
                          word wrap feature is on (XXXXmmmmNNNNwwwwoooorrrrddddWWWWrrrraaaapppp is
                          True), this will ignore the newlines
                          automatically inserted by the widget. This
                          is the default.

                       6. XXXXmmmmSSSSEEEELLLLEEEECCCCTTTT____OOOOUUUUTTTT____LLLLIIIINNNNEEEE, which selects a line of
                          text. This action sees a line as delimited
                          by _h_a_r_d or _s_o_f_t newline characters. In other
                          words, if the word wrap feature is on
                          (XXXXmmmmNNNNwwwwoooorrrrddddWWWWrrrraaaapppp is True), the newlines
                          automatically inserted by the widget will be
                          treated as delimiting lines.

                       7. XXXXmmmmSSSSEEEELLLLEEEECCCCTTTT____AAAALLLLLLLL, which selects all of the text.

          XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyyCCCCoooouuuunnnntttt
                    Indicates the number of elements in the
                    XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyy resource.  The value must not be
                    negative.

          XXXXmmmmNNNNsssseeeelllleeeeccccttttTTTThhhhrrrreeeesssshhhhoooolllldddd
                    Specifies the number of pixels of motion that is
                    required to select the next character when
                    selection is performed using the click-drag mode
                    of selection.  The value must not be negative.
                    This resource also specifies whether a drag should
                    be started and the number of pixels to start a



     Page 11                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    drag when BBBBttttnnnn2222DDDDoooowwwwnnnn and BBBBttttnnnn1111DDDDoooowwwwnnnn are integrated.
                                                  XXXXmmmmTTTTeeeexxxxtttt OOOOuuuuttttppppuuuutttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
                    NNNNaaaammmmeeee                       CCCCllllaaaassssssss                      TTTTyyyyppppeeee            DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
                    XmNblinkRate               XmCBlinkRate               int             500       CSG
                    XmNcolumns                 XmCColumns                 short           dynamic   CSG
                    XmNcursorPositionVisible   XmCCursorPositionVisible   Boolean         True      CSG
                    XmNfontList                XmCFontList                XmFontList      dynamic   CSG
                    XmNrenderTable             XmCRenderTable             XmRenderTable   dynamic   CSG
                    XmNresizeHeight            XmCResizeHeight            Boolean         False     CSG
                    XmNresizeWidth             XmCResizeWidth             Boolean         False     CSG
                    XmNrows                    XmCRows                    short           dynamic   CSG
                    XmNwordWrap                XmCWordWrap                Boolean         False     CSG

          XXXXmmmmNNNNbbbblllliiiinnnnkkkkRRRRaaaatttteeee
                    Specifies the blink rate of the text cursor in
                    milliseconds.  The time indicated in the blink
                    rate relates to the time the cursor is visible and
                    the time the cursor is invisible (that is, the
                    time it takes to blink the insertion cursor on and
                    off is twice the blink rate). The cursor does not
                    blink when the blink rate is set to 0 (zero).  The
                    value must not be negative.

          XXXXmmmmNNNNccccoooolllluuuummmmnnnnssss
                    Specifies the initial width of the text window as
                    an integer number of characters. The width equals
                    the number of characters specified by this
                    resource multiplied by the width as derived from
                    the specified font. If the em-space value is
                    available, it is used. If not, the width of the
                    numeral "0" is used. If this is not available, the
                    maximum width is used.  For proportionate fonts,
                    the actual number of characters that fit on a
                    given line may be greater than the value
                    specified.  The value must be greater than 0
                    (zero). The default value depends on the value of
                    the XXXXmmmmNNNNwwwwiiiiddddtttthhhh resource.  If no width is specified
                    the default is 20.

                    When the _X_m_N_l_a_y_o_u_t_D_i_r_e_c_t_i_o_n resource is
                    _X_m_T_O_P__T_O__B_O_T_T_O_M, and if the _X_m_T_e_x_twidget resource
                    _X_m_N_e_d_i_t_M_o_d_e is _X_m_S_I_N_G_L_E__L_I_N_E__E_D_I_T, this attribute
                    is ignored. If no width is specified, the default
                    is 1.

          XXXXmmmmNNNNccccuuuurrrrssssoooorrrrPPPPoooossssiiiittttiiiioooonnnnVVVViiiissssiiiibbbblllleeee
                    Indicates that the insert cursor position is
                    marked by a text cursor when the Boolean value is
                    True.

          XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt
                    Specifies the font list to be used for Text. The



     Page 12                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    font list is an obsolete structure and is retained
                    only for compatibility with earlier releases of
                    Motif. Use the render table (XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee)
                    instead of font lists wherever possible. If both
                    are specified, the render table will take
                    precedence. If this value is NULL at
                    initialization, the parent hierarchy of the widget
                    is searched for an ancestor that holds the
                    _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e trait. If such an ancestor
                    is found, the font list is initialized to the
                    XXXXmmmmTTTTEEEEXXXXTTTT____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE value of the ancestor widget.
                    If no such ancestor is found, the default is
                    implementation dependent.

                    Text searches the font list for the first
                    occurrence of a font set that has
                    XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG. If a default element is
                    not found, the first font set in the font list is
                    used. If the list contains no font sets, the first
                    font in the font list will be used. Refer to
                    XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt(3) for more information on a font list
                    structure.

          XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee
                    Specifies the render table to be used in deriving
                    a font set or font for rendering text. If both a
                    render table and a font list are specified, the
                    render table will take precedence. If the value of
                    XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee is NULL at initialization, the
                    parent hierarchy of the widget is searched for an
                    ancestor that holds the _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e
                    trait. If such an ancestor is found, the font list
                    is initialized to the XXXXmmmmTTTTEEEEXXXXTTTT____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE value of
                    the ancestor widget. If no such ancestor is found,
                    the default is implementation dependent.

                    Text searches the render table for the first
                    occurrence of a rendition that has the tag
                    ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFAAAAUUUULLLLTTTT____LLLLOOOOCCCCAAAALLLLEEEE. If a default element is not
                    found, the first rendition in the table is used.
                    Refer to XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee(3) for more information on
                    the render table structure.

          XXXXmmmmNNNNrrrreeeessssiiiizzzzeeeeHHHHeeeeiiiigggghhhhtttt
                    Indicates that Text will attempt to resize its
                    height to accommodate all the text contained in
                    the widget when the Boolean value is True. If the
                    Boolean value is set to True, the text is always
                    displayed, starting from the first position in the
                    source, even if instructed otherwise. This
                    attribute is ignored when the application uses a
                    Text widget whose parent is a ScrolledWindow and



     Page 13                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    when XXXXmmmmNNNNssssccccrrrroooollllllllVVVVeeeerrrrttttiiiiccccaaaallll is True.

                    When the _X_m_N_l_a_y_o_u_t_D_i_r_e_c_t_i_o_n resource is
                    _X_m_T_O_P__T_O__B_O_T_T_O_M, this resource indicates that the
                    text attempts to resize its height to accommodate
                    all the text contained in the widget when the
                    Boolean value is TTTTrrrruuuueeee. This attribute is ignored
                    if _X_m_N_w_o_r_d_W_r_a_p is TTTTrrrruuuueeee.

          XXXXmmmmNNNNrrrreeeessssiiiizzzzeeeeWWWWiiiiddddtttthhhh
                    Indicates that Text attempts to resize its width
                    to accommodate all the text contained in the
                    widget when the Boolean value is True.  This
                    attribute is ignored if XXXXmmmmNNNNwwwwoooorrrrddddWWWWrrrraaaapppp is True.

                    When the _X_m_N_l_a_y_o_u_t_D_i_r_e_c_t_i_o_n resource is
                    _X_m_T_O_P__T_O__B_O_T_T_O_M, this attribute is still effective
                    even if _X_m_N_w_o_r_d_W_r_a_p is TTTTrrrruuuueeee.  Also, this attribute
                    is ignored when the application uses a text widget
                    whose parent is a SSSSccccrrrroooolllllllleeeeddddWWWWiiiinnnnddddoooowwww and
                    _X_m_N_s_c_r_o_l_l_H_o_r_i_z_a_o_n_t_a_l is TTTTrrrruuuueeee.

          XXXXmmmmNNNNrrrroooowwwwssss   Specifies the initial height of the text window
                    measured in character heights. This attribute is
                    ignored if the text widget resource XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is
                    XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT.  The value must be greater
                    than 0 (zero).  The default value depends on the
                    value of the XXXXmmmmNNNNhhhheeeeiiiigggghhhhtttt resource.  If no height is
                    specified, the default is 1.

                    When the _X_m_N_l_a_y_o_u_t_D_i_r_e_c_t_i_o_n resource is
                    _X_m_T_O_P__T_O__B_O_T_T_O_M, this attribute is still
                    effective, even if the _X_m_T_e_x_t widget resource
                    _X_m_N_e_d_i_t_M_o_d_e is _X_m_S_I_N_G_L_E__L_I_N_E__E_D_I_T. If no height is
                    specified, the default is 20.

          XXXXmmmmNNNNwwwwoooorrrrddddWWWWrrrraaaapppp
                    Indicates that lines are to be broken at word
                    breaks (that is, the text does not go off the
                    right edge of the window) when the Boolean value
                    is True.  Words are defined as a sequence of
                    characters separated by whitespace. Whitespace is
                    defined as a space, tab, or newline. This
                    attribute is ignored if the text widget resource
                    XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT.  Note that this
                    resource is only valid when the widget is not a
                    scroll one, or, if the widget is a scroll widget,
                    that the XXXXmmmmNNNNssssccccrrrroooollllllllHHHHoooorrrriiiizzzzoooonnnnttttaaaallll resource is False.

                    Indicates that lines are to be broken at word
                    breaks (that is, when the _X_m_N_l_a_y_o_u_t_D_i_r_e_c_t_i_o_n
                    resource is _X_m_T_O_P__T_O__B_O_T_T_O_M, the text does not go



     Page 14                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    off the bottom edge of the window) when the
                    Boolean value is TTTTrrrruuuueeee.

          The following resources are used only when text is created
          in a ScrolledWindow. See the reference page for
          XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSccccrrrroooolllllllleeeeddddTTTTeeeexxxxtttt.
                           XXXXmmmmTTTTeeeexxxxtttt SSSSccccrrrroooolllllllliiiinnnngggg RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
          NNNNaaaammmmeeee                  CCCCllllaaaassssssss           TTTTyyyyppppeeee      DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
          XmNscrollHorizontal   XmCScroll       Boolean   True      CG
          XmNscrollLeftSide     XmCScrollSide   Boolean   False     CG
          XmNscrollTopSide      XmCScrollSide   Boolean   False     CG
          XmNscrollVertical     XmCScroll       Boolean   True      CG

          Note in connection with this table that if the
          _X_m_N_l_a_y_o_u_t_D_i_r_e_c_t_i_o_n resource is _X_m_T_O_P__T_O__B_O_T_T_O_M, the default
          is TTTTrrrruuuueeee.

          XXXXmmmmNNNNssssccccrrrroooollllllllHHHHoooorrrriiiizzzzoooonnnnttttaaaallll
                    Adds a ScrollBar that allows the user to scroll
                    horizontally through text when the Boolean value
                    is True.  This resource is forced to False when
                    the Text widget is placed in a ScrolledWindow with
                    XXXXmmmmNNNNssssccccrrrroooolllllllliiiinnnnggggPPPPoooolllliiiiccccyyyy set to XXXXmmmmAAAAUUUUTTTTOOOOMMMMAAAATTTTIIIICCCC.

                    When the _X_m_N_l_a_y_o_u_t_D_i_r_e_c_t_i_o_n resource is
                    _X_m_T_O_P__T_O__B_O_T_T_O_M, this attribute is ignored if the
                    _X_m_T_e_x_t widget resource _X_m_N_e_d_i_t_M_o_d_eis
                    _X_m_S_I_N_G_L_E__L_I_N_E__E_D_I_T.

          XXXXmmmmNNNNssssccccrrrroooollllllllLLLLeeeeffffttttSSSSiiiiddddeeee
                    Indicates that the vertical ScrollBar should be
                    placed on the left side of the scrolled text
                    window when the Boolean value is True. This
                    attribute is ignored if XXXXmmmmNNNNssssccccrrrroooollllllllVVVVeeeerrrrttttiiiiccccaaaallll is False
                    or the Text resource XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is
                    XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT.

                    When the _X_m_N_l_a_y_o_u_t_D_i_r_e_c_t_i_o_n resource is
                    _X_m_T_O_P__T_O__B_O_T_T_O_M, this resource is still effective,
                    even if the XmText widget resource _X_m_N_e_d_i_t_M_o_d_e is
                    _X_m_S_I_N_G_L_E__L_I_N_E__E_D_I_T.

          XXXXmmmmNNNNssssccccrrrroooollllllllTTTTooooppppSSSSiiiiddddeeee
                    Indicates that the horizontal ScrollBar should be
                    placed on the top side of the scrolled text window
                    when the Boolean value is True.

                    When the _X_m_N_l_a_y_o_u_t_D_i_r_e_c_t_i_o_n resource is
                    _X_m_T_O_P__T_O__B_O_T_T_O_M, this attribute is ignored if
                    _X_m_N_s_c_r_o_l_l_H_o_r_i_z_o_n_t_a_l is FFFFaaaallllsssseeeeor the XXXXmmmmtttteeeexxxxtttt resource
                    _X_m_N_e_d_i_t_M_o_d_e is _X_m_S_I_N_G_L_E__L_I_N_E__E_D_I_T.




     Page 15                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



          XXXXmmmmNNNNssssccccrrrroooollllllllVVVVeeeerrrrttttiiiiccccaaaallll
                    Adds a ScrollBar that allows the user to scroll
                    vertically through text when the Boolean value is
                    True.  This attribute is ignored if the Text
                    resource XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT.  This
                    resource is forced to False when the Text widget
                    is placed in a ScrolledWindow with
                    XXXXmmmmNNNNssssccccrrrroooolllllllliiiinnnnggggPPPPoooolllliiiiccccyyyy set to XXXXmmmmAAAAUUUUTTTTOOOOMMMMAAAATTTTIIIICCCC.

                    When the _X_m_N_l_a_y_o_u_t_D_i_r_e_c_t_i_o_n resource is
                    _X_m_T_O_P__T_O__B_O_T_T_O_M, this resource is still effective,
                    even if the _X_m_T_e_x_twidget resource _X_m_N_e_d_i_t_M_o_d_eis
                    _X_m_S_I_N_G_L_E__L_I_N_E__E_D_I_T.

        IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
          Text inherits behavior and resources from the superclasses
          described in the following tables.  For a complete
          description of each resource, refer to the reference page
          for that superclass.
                                               XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
          NNNNaaaammmmeeee                      CCCCllllaaaassssssss                   TTTTyyyyppppeeee               DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
          XmNbottomShadowColor      XmCBottomShadowColor    Pixel              dynamic                CSG
          XmNbottomShadowPixmap     XmCBottomShadowPixmap   Pixmap             XmUNSPECIFIED_PIXMAP   CSG
          XmNconvertCallback        XmCCallback             XtCallbackList     NULL                   C
          XmNforeground             XmCForeground           Pixel              dynamic                CSG
          XmNhelpCallback           XmCCallback             XtCallbackList     NULL                   C
          XmNhighlightColor         XmCHighlightColor       Pixel              dynamic                CSG
          XmNhighlightOnEnter       XmCHighlightOnEnter     Boolean            False                  CSG
          XmNhighlightPixmap        XmCHighlightPixmap      Pixmap             dynamic                CSG
          XmNhighlightThickness     XmCHighlightThickness   Dimension          2                      CSG
          XmNlayoutDirection        XmCLayoutDirection      XmDirection        dynamic                CG
          XmNnavigationType         XmCNavigationType       XmNavigationType   XmTAB_GROUP            CSG
          XmNpopupHandlerCallback   XmCCallback             XtCallbackList     NULL                   C
          XmNshadowThickness        XmCShadowThickness      Dimension          2                      CSG
          XmNtopShadowColor         XmCTopShadowColor       Pixel              dynamic                CSG
          XmNtopShadowPixmap        XmCTopShadowPixmap      Pixmap             dynamic                CSG
          XmNtraversalOn            XmCTraversalOn          Boolean            True                   CSG
          XmNunitType               XmCUnitType             unsigned char      dynamic                CSG
          XmNuserData               XmCUserData             XtPointer          NULL                   CSG
                                                        CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
          NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
          XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
          XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
          XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
          XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
          XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
          XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
          XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
          XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
          XmNdepth                        XmCDepth                        int              dynamic                CG





     Page 16                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



          XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
          XmNheight                       XmCHeight                       Dimension        dynamic                CSG
          XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
          XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
          XmNscreen                       XmCScreen                       Screen *         dynamic                CG
          XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
          XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
          XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
          XmNx                            XmCPosition                     Position         0                      CSG
          XmNy                            XmCPosition                     Position         0                      CSG

        CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
          A pointer to the following structure is passed to each
          callback:

          typedef struct
          {
                  int _r_e_a_s_o_n;
                  XEvent * _e_v_e_n_t;
          } XmAnyCallbackStruct;

          _r_e_a_s_o_n    Indicates why the callback was invoked

          _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback

          The Text widget defines a new callback structure for use
          with verification callbacks. Note that not all fields are
          relevant for every callback reason. The application must
          first look at the _r_e_a_s_o_n field and use only the structure
          members that are valid for the particular reason.  The
          values _s_t_a_r_t_P_o_s, _e_n_d_P_o_s, and _t_e_x_t in the callback structure
          XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt may be modified when the callback
          is received, and these changes will be reflected as changes
          made to the source of the Text widget. (For example, all
          keystrokes can be converted to spaces or NULL characters
          when a password is entered into a Text widget.) The
          application programmer should not overwrite the _t_e_x_t field,
          but should attach data to that pointer.

          A pointer to the following structure is passed to callbacks
          for XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk, XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk, and
          XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk:

          typedef struct
          {
                  int _r_e_a_s_o_n;
                  XEvent * _e_v_e_n_t;
                  Boolean _d_o_i_t;
                  XmTextPosition _c_u_r_r_I_n_s_e_r_t, _n_e_w_I_n_s_e_r_t;
                  XmTextPosition _s_t_a_r_t_P_o_s, _e_n_d_P_o_s;
                  XmTextBlock _t_e_x_t;
          } XmTextVerifyCallbackStruct, *XmTextVerifyPtr;



     Page 17                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



          _r_e_a_s_o_n    Indicates why the callback was invoked.

          _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback.
                    It can be NULL. For example, changes made to the
                    Text widget programmatically do not have an event
                    that can be passed to the associated callback.

          _d_o_i_t      Indicates whether the action that invoked the
                    callback is performed.  Setting _d_o_i_t to False
                    negates the action.  Note that not all actions may
                    be negated. For example, XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS
                    callbacks may be beyond the control of the widget
                    if they are produced by mouse clicks.

          _c_u_r_r_I_n_s_e_r_t
                    Indicates the current position of the insert
                    cursor.

          _n_e_w_I_n_s_e_r_t Indicates the position at which the user attempts
                    to position the insert cursor.

          _s_t_a_r_t_P_o_s  Indicates the starting position of the text to
                    modify. If the callback is not a modify
                    verification callback, this value is the same as
                    _c_u_r_r_I_n_s_e_r_t.

          _e_n_d_P_o_s    Indicates the ending position of the text to
                    modify. If no text is replaced or deleted, the
                    value is the same as _s_t_a_r_t_P_o_s. If the callback is
                    not a modify verification callback, this value is
                    the same as _c_u_r_r_I_n_s_e_r_t.

          _t_e_x_t      Points to a structure of type XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkkRRRReeeecccc. This
                    structure holds the textual information to be
                    inserted.

          typedef struct
          {
                  char *_p_t_r;
                  int _l_e_n_g_t_h;
                  XmTextFormat _f_o_r_m_a_t;
          } XmTextBlockRec, *XmTextBlock;

               _p_t_r       Points to the text to be inserted.

               _l_e_n_g_t_h    Specifies the length of the text to be
                         inserted.

               _f_o_r_m_a_t    Specifies the format of the text, either
                         XXXXmmmmFFFFMMMMTTTT____8888____BBBBIIIITTTT or XXXXmmmmFFFFMMMMTTTT____11116666____BBBBIIIITTTT.

          A pointer to the following structure is passed to callbacks



     Page 18                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



          for XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss.

          typedef struct
          {
                  int _r_e_a_s_o_n;
                  XEvent *_e_v_e_n_t;
                  Boolean _d_o_i_t;
                  XmTextPosition _c_u_r_r_I_n_s_e_r_t, _n_e_w_I_n_s_e_r_t;
                  XmTextPosition _s_t_a_r_t_P_o_s, _e_n_d_P_o_s;
                  XmTextBlockWcs _t_e_x_t;
          } XmTextVerifyCallbackStructWcs, *XmTextVerifyPtrWcs;

          _r_e_a_s_o_n    Indicates why the callback was invoked.

          _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback.
                    It can be NULL. For example, changes made to the
                    Text widget programmatically do not have an event
                    that can be passed to the associated callback.

          _d_o_i_t      Indicates whether the action that invoked the
                    callback is performed.  Setting _d_o_i_t to False
                    negates the action.  Note that not all actions may
                    be negated. For example, XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS
                    callbacks may be beyond the control of the widget
                    if they are produced by mouse clicks.

          _c_u_r_r_I_n_s_e_r_t
                    Indicates the current position of the insert
                    cursor.

          _n_e_w_I_n_s_e_r_t Indicates the position at which the user attempts
                    to position the insert cursor.

          _s_t_a_r_t_P_o_s  Indicates the starting position of the text to
                    modify. If the callback is not a modify
                    verification callback, this value is the same as
                    _c_u_r_r_I_n_s_e_r_t.

          _e_n_d_P_o_s    Indicates the ending position of the text to
                    modify. If no text is replaced or deleted, the
                    value is the same as _s_t_a_r_t_P_o_s. If the callback is
                    not a modify verification callback, this value is
                    the same as _c_u_r_r_I_n_s_e_r_t.

          _t_e_x_t      Points to the following structure of type
                    XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkkRRRReeeeccccWWWWccccssss. This structure holds the
                    textual information to be inserted.

          typedef struct
          {
                  wchar_t *_w_c_s_p_t_r;
                  int _l_e_n_g_t_h;



     Page 19                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



          } XmTextBlockRecWcs, *XmTextBlockWcs;

               _w_c_s_p_t_r    Points to the wide character text to be
                         inserted.

               _l_e_n_g_t_h    Specifies the number of characters to be
                         inserted.

          The following table describes the reasons for which the
          individual verification callback structure fields are valid.
          Note that the _e_v_e_n_t field will never be valid for
          XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.
          RRRReeeeaaaassssoooonnnn                      VVVVaaaalllliiiidddd FFFFiiiieeeellllddddssss
          XmCR_LOSING_FOCUS           _r_e_a_s_o_n, _e_v_e_n_t, _d_o_i_t, _c_u_r_r_I_n_s_e_r_t,
                                      _n_e_w_I_n_s_e_r_t, _s_t_a_r_t_P_o_s, _e_n_d_P_o_s
          XmCR_MODIFYING_TEXT_VALUE   _r_e_a_s_o_n, _e_v_e_n_t, _d_o_i_t, _c_u_r_r_I_n_s_e_r_t,
                                      _n_e_w_I_n_s_e_r_t, _s_t_a_r_t_P_o_s, _e_n_d_P_o_s, _t_e_x_t
          XmCR_MOVING_INSERT_CURSOR   _r_e_a_s_o_n, _d_o_i_t, _c_u_r_r_I_n_s_e_r_t, _n_e_w_I_n_s_e_r_t

          A pointer to the following callback structure is passed to
          the XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures:

          typedef struct
          {
                  int _r_e_a_s_o_n;
                  XEvent  *_e_v_e_n_t;
                  Atom _s_e_l_e_c_t_i_o_n;
                  XtEnum _o_p_e_r_a_t_i_o_n;
                  int _f_l_a_g_s;
                  XtPointer _t_r_a_n_s_f_e_r__i_d;
                  XtPointer _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a;
                  XtPointer _l_o_c_a_t_i_o_n__d_a_t_a;
                  Time _t_i_m_e;
          } XmDestinationCallbackStruct;

          _r_e_a_s_o_n    Indicates why the callback was invoked.

          _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback.
                    It can be NULL.

          _s_e_l_e_c_t_i_o_n Indicates the selection for which data transfer is
                    being requested.  Possible values are _C_L_I_P_B_O_A_R_D,
                    _P_R_I_M_A_R_Y, _S_E_C_O_N_D_A_R_Y, and ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP.

          _o_p_e_r_a_t_i_o_n Indicates the type of transfer operation
                    requested.

                       +o  When the selection is _P_R_I_M_A_R_Y or _S_E_C_O_N_D_A_R_Y,
                          possible values are XXXXmmmmMMMMOOOOVVVVEEEE, XXXXmmmmCCCCOOOOPPPPYYYY, and
                          XXXXmmmmLLLLIIIINNNNKKKK.

                       +o  When the selection is _C_L_I_P_B_O_A_R_D, possible



     Page 20                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                          values are XXXXmmmmCCCCOOOOPPPPYYYY and XXXXmmmmLLLLIIIINNNNKKKK.

                       +o  When the selection is ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP, possible
                          values are XXXXmmmmMMMMOOOOVVVVEEEE, XXXXmmmmCCCCOOOOPPPPYYYY, XXXXmmmmLLLLIIIINNNNKKKK, and
                          XXXXmmmmOOOOTTTTHHHHEEEERRRR.  A value of XXXXmmmmOOOOTTTTHHHHEEEERRRR means that the
                          callback procedure must get further
                          information from the
                          XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt structure in the
                          _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a member.

          _f_l_a_g_s     Indicates whether or not the destination widget is
                    also the source of the data to be transferred.
                    Following are the possible values:

                    XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____NNNNOOOONNNNEEEE
                              The destination widget is not the source
                              of the data to be transferred.

                    XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____SSSSAAAAMMMMEEEE
                              The destination widget is the source of
                              the data to be transferred.

          ttttrrrraaaannnnssssffffeeeerrrr____iiiidddd
                    Serves as a unique ID to identify the transfer
                    transaction.

          _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a
                    Contains information about the destination.  When
                    the selection is ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP, the callback
                    procedures are called by the drop site's
                    XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc, and _d_e_s_t_i_n_a_t_i_o_n__d_a_t_ais a pointer to
                    the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt structure passed to
                    the XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc procedure.  When the selection is
                    _S_E_C_O_N_D_A_R_Y, _d_e_s_t_i_n_a_t_i_o_n__d_a_t_ais an Atom representing
                    a target recommmended by the selection owner for
                    use in converting the selection.  Otherwise,
                    _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a is NULL.

          llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa
                    Contains information about the location where data
                    is to be transferred.  The value is always NULL
                    when the selection is _C_L_I_P_B_O_A_R_D.  If the value is
                    NULL, the data is to be inserted at the widget's
                    cursor position.  Otherwise, the value is a
                    pointer to an _X_P_o_i_n_t structure containing the x-
                    and y- coordinates at the location where the data
                    is to be transferred. Once _X_m_T_r_a_n_s_f_e_r_D_o_n_e
                    procedures start to be called, llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa will
                    no longer be stable.

          _t_i_m_e      Indicates the time when the transfer operation
                    began.



     Page 21                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



        TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
          The XXXXmmmmTTTTeeeexxxxtttt translations are described in the following list.
          The actions represent the effective behavior of the
          associated events, and they may differ in a right-to-left
          language environment.

          The following key names are listed in the X standard key
          event translation table syntax.  This format is the one used
          by Motif to specify the widget actions corresponding to a
          given key.  A brief overview of the format is provided under
          VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3).  For a complete description of the
          format, please refer to the X Toolkit Instrinsics
          Documentation.

          ~~~~cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
                    extend-start()

          cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
                    move-destination()

          ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
                    grab-focus()

          ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111MMMMoooottttiiiioooonnnn>>>>:
                    extend-adjust()

          ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>:
                    extend-end()

          <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>:
                    process-bdrag()

          mmmm ~~~~aaaa <<<<BBBBttttnnnn2222MMMMoooottttiiiioooonnnn>>>>:
                    secondary-adjust()

          ~~~~mmmm aaaa <<<<BBBBttttnnnn2222MMMMoooottttiiiioooonnnn>>>>:
                    secondary-adjust()

          ssss cccc <<<<BBBBttttnnnn2222UUUUpppp>>>>:
                    link-to()

          ~~~~ssss <<<<BBBBttttnnnn2222UUUUpppp>>>>:
                    copy-to()

          ~~~~cccc <<<<BBBBttttnnnn2222UUUUpppp>>>>:
                    move-to()

          ::::mmmm <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPrrrriiiimmmmaaaarrrryyyyPPPPaaaasssstttteeee>>>>:
                    cut-primary()

          ::::aaaa <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPrrrriiiimmmmaaaarrrryyyyPPPPaaaasssstttteeee>>>>:
                    cut-primary()



     Page 22                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPrrrriiiimmmmaaaarrrryyyyPPPPaaaasssstttteeee>>>>:
                    copy-primary()

          ::::mmmm <<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCuuuutttt>>>>:
                    cut-primary()

          ::::aaaa <<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCuuuutttt>>>>:
                    cut-primary()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCuuuutttt>>>>:
                    cut-clipboard()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaasssstttteeee>>>>:
                    paste-clipboard()

          ::::mmmm <<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCooooppppyyyy>>>>:
                    copy-primary()

          ::::aaaa <<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCooooppppyyyy>>>>:
                    copy-primary()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCooooppppyyyy>>>>:
                    copy-clipboard()

          ::::ssss cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>>:
                    beginning-of-file(_e_x_t_e_n_d)

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>>:
                    beginning-of-file()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>>:
                    beginning-of-line(_e_x_t_e_n_d)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>>:
                    beginning-of-line()

          ::::ssss cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>>:
                    end-of-file(_e_x_t_e_n_d)

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>>:
                    end-of-file()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>>:
                    end-of-line(_e_x_t_e_n_d)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>>:
                    end-of-line()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeLLLLeeeefffftttt>>>>:
                    page-left(_e_x_t_e_n_d) (ignored in vertical writing)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeLLLLeeeefffftttt>>>>:



     Page 23                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    page-left() (next-page() in vertical writing)

          ::::ssss cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeUUUUpppp>>>>:
                    page-left(_e_x_t_e_n_d)

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeUUUUpppp>>>>:
                    page-left()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeUUUUpppp>>>>:
                    previous-page(_e_x_t_e_n_d) (ignored in vertical
                    writing)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeUUUUpppp>>>>:
                    previous-page() (page-up() in vertical writing)

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeRRRRiiiigggghhhhtttt>>>>:
                    page-right(_e_x_t_e_n_d) (ignored in vertical writing)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeRRRRiiiigggghhhhtttt>>>>:
                    page-right() (previous-page() in vertical writing)

          ssss cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeDDDDoooowwwwnnnn>>>>:
                    page-right(_e_x_t_e_n_d) (ignored in vertical writing)

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeDDDDoooowwwwnnnn>>>>:
                    page-right()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeDDDDoooowwwwnnnn>>>>:
                    next-page(_e_x_t_e_n_d) (ignored in vertical writing)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeDDDDoooowwwwnnnn>>>>:
                    next-page() (page-down() in vertical writing)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCClllleeeeaaaarrrr>>>>:
                    clear-selection()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBaaaacccckkkkSSSSppppaaaacccceeee>>>>:
                    delete-previous-character()

          ::::ssss mmmm <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeelllleeeetttteeee>>>>:
                    cut-primary()

          ::::ssss aaaa <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeelllleeeetttteeee>>>>:
                    cut-primary()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeelllleeeetttteeee>>>>:
                    cut-clipboard()

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeelllleeeetttteeee>>>>:
                    delete-to-end-of-line()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeelllleeeetttteeee>>>>:



     Page 24                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    delete-next-character()

          ::::cccc mmmm <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>:
                    copy-primary()

          ::::cccc aaaa <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>:
                    copy-primary()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>:
                    paste-clipboard()

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>:
                    copy-clipboard()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffSSSSeeeelllleeeecccctttt>>>>:
                    key-select()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffSSSSeeeelllleeeecccctttt>>>>:
                    set-anchor()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffSSSSeeeelllleeeeccccttttAAAAllllllll>>>>:
                    select-all()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeesssseeeelllleeeeccccttttAAAAllllllll>>>>:
                    deselect-all()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAccccttttiiiivvvvaaaatttteeee>>>>:
                    activate()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAddddddddMMMMooooddddeeee>>>>:
                    toggle-add-mode()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffHHHHeeeellllpppp>>>>:
                    Help()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCaaaannnncccceeeellll>>>>:
                    process-cancel()

          ::::ssss cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
                    backward-word(_e_x_t_e_n_d) ( forward-paragraph(_e_x_t_e_n_d)
                    in vertical writing)

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
                    backward-word() (forward-paragraph() in vertical
                    writing)

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
                    key-select(_l_e_f_t)(process-shift-left() in vertical
                    writing)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
                    backward-character() (process-left()in vertical



     Page 25                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    writing)

          ::::ssss cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
                    forward-word(_e_x_t_e_n_d)(backward-paragraph(_e_x_t_e_n_d)in
                    vertical writing)

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
                    forward-word() (backward-paragraph()in vertical
                    writing)

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
                    key-select(_r_i_g_h_t)(process-shift-right in vertical
                    writing)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
                    forward-character() (process-right()in vertical
                    writing)

          ::::ssss cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>:
                    backward-paragraph(_e_x_t_e_n_d)(backward-word(_e_x_t_e_n_d)in
                    vertical writing)

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>:
                    backward-paragraph() (backward-word()in vertical
                    writing)

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>:
                    process-shift-up()(key-select(_u_p)in vertical
                    writing)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>:
                    process-up() (backward-character()in vertical
                    writing)

          ::::ssss cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>:
                    forward-paragraph(_e_x_t_e_n_d)(forward-word(_e_x_t_e_n_d)in
                    vertical writing)

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>:
                    forward-paragraph() (forward-word()in vertical
                    writing)

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>:
                    process-shift-down()(key-select(_d_o_w_n)in vertical
                    writing)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>:
                    process-down() (forward-character()in vertical
                    writing)

          cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>ssssllllaaaasssshhhh:
                    select-all()



     Page 26                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



          cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>bbbbaaaacccckkkkssssllllaaaasssshhhh:
                    deselect-all()

          ssss cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb:
                    prev-tab-group()

          ~~~~ssss cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb:
                    next-tab-group()

          ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb:
                    process-tab(_P_r_e_v)

          ~~~~ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb:
                    process-tab(_N_e_x_t)

          ~~~~ssss cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>RRRReeeettttuuuurrrrnnnn:
                    activate()

          ~~~~ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>RRRReeeettttuuuurrrrnnnn:
                    process-return()

          ~~~~ssss cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee:
                    set-anchor()

          ssss cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee:
                    key-select()

          ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee:
                    self-insert()

          <<<<KKKKeeeeyyyy>>>>:    self-insert()

          The Text button event translations are modified when
          Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource does not have a
          value of XXXXmmmmOOOOFFFFFFFF (in other words, it is either
          XXXXmmmmBBBBUUUUTTTTTTTTOOOONNNN2222____TTTTRRRRAAAANNNNSSSSFFFFEEEERRRR or XXXXmmmmBBBBUUUUTTTTTTTTOOOONNNN2222____AAAADDDDJJJJUUUUSSSSTTTT). This option allows
          the actions for selection and transfer to be integrated on
          <<<<BBBBttttnnnn1111>>>>, and the actions for extending the selection can be
          bound to <<<<BBBBttttnnnn2222>>>>. The actions for <<<<BBBBttttnnnn1111>>>> that are defined
          above still apply when the <<<<BBBBttttnnnn1111>>>> event occurs over text
          that is not selected. The following actions apply when the
          <<<<BBBBttttnnnn1111>>>> event occurs over text that is selected:

          <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
                    process-bdrag().

          <<<<SSSShhhhiiiifffftttt>>>><<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
                    process-bdrag().

          <<<<CCCCttttrrrrllll>>>><<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
                    process-bdrag().




     Page 27                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



          <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>><<<<SSSShhhhiiiifffftttt>>>><<<<BBBBttttnnnn1111UUUUpppp>>>>:
                    grab-focus(), eeeexxxxtttteeeennnndddd----eeeennnndddd.

          <<<<SSSShhhhiiiifffftttt>>>><<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>><<<<SSSShhhhiiiifffftttt>>>><<<<BBBBttttnnnn1111UUUUpppp>>>>:
                    extend-start(), extend-end().

          <<<<CCCCttttrrrrllll>>>><<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>><<<<SSSShhhhiiiifffftttt>>>><<<<BBBBttttnnnn1111UUUUpppp>>>>:
                    move-destination().

          When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource has a value of
          XXXXmmmmBBBBUUUUTTTTTTTTOOOONNNN2222____AAAADDDDJJJJUUUUSSSSTTTT, the following actions apply:

          <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>:
                    extend-start().

          <<<<BBBBttttnnnn2222MMMMoooottttiiiioooonnnn>>>>:
                    extend-adjust().

          <<<<BBBBttttnnnn2222UUUUpppp>>>>: extend-end().

        AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss
          The XXXXmmmmTTTTeeeexxxxtttt action routines are

          activate():
                    Calls the callbacks for XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk.
                    Passes the event to the parent.

          backward-character(_e_x_t_e_n_d):
                    Moves the insertion cursor one character to the
                    left.  This action may have different behavior in
                    a right-to-left language environment.

                    If called with an argument of _e_x_t_e_n_d, moves the
                    insertion cursor as in the case of no argument and
                    extends the current selection.

                    The backward-character() action produces calls to
                    the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the backward-character()
                    action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

                    In vertical writing, if _X_m_N_e_d_i_t_M_o_d_e is
                    _X_m_S_I_N_G_L_E__L_I_N_E__E_D_I_T and _X_m_N_n_a_v_i_g_a_t_i_o_n_T_y_p_eis _X_m_N_O_N_E,
                    traverses to the widget to the left in the tab
                    group. If _X_m_N_e_d_i_t_M_o_d_e is _X_m_M_U_L_T_I__L_I_N_E__E_D_I_T, moves
                    the insertion cursor to the next line in the same
                    column.

          backward-paragraph(_e_x_t_e_n_d):



     Page 28                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and this
                    action is called with no argument, moves the
                    insertion cursor to the first non-whitespace
                    character following the first previous blank line
                    or beginning of the text.  If the insertion cursor
                    is already at the beginning of a paragraph, moves
                    the insertion cursor to the beginning of the
                    previous paragraph.

                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and this
                    action is called with an argument of _e_x_t_e_n_d, moves
                    the insertion cursor as in the case of no argument
                    and extends the current selection.

                    The backward-paragraph() action produces calls to
                    the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the backward-paragraph()
                    action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

          backward-word(_e_x_t_e_n_d):
                    If this action is called with no argument, moves
                    the insertion cursor to the first non-whitespace
                    character after the first whitespace character to
                    the left or after the beginning of the line.  If
                    the insertion cursor is already at the beginning
                    of a word, moves the insertion cursor to the
                    beginning of the previous word.  This action may
                    have different behavior in a locale other than the
                    C locale.

                    If called with an argument of _e_x_t_e_n_d, moves the
                    insertion cursor as in the case of no argument and
                    extends the current selection.

                    The backward-word() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the backward-word() action
                    may produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

          beep():   Causes the terminal to beep.  The beep() action
                    produces no callbacks.

          beginning-of-file(_e_x_t_e_n_d):
                    If this action is called with no argument, moves
                    the insertion cursor to the beginning of the text.




     Page 29                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    If called with an argument of _e_x_t_e_n_d, moves the
                    insertion cursor as in the case of no argument and
                    extends the current selection.

                    The beginning-of-file() action produces calls to
                    the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the beginning-of-file()
                    action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

          beginning-of-line(_e_x_t_e_n_d):
                    If this action is called with no argument, moves
                    the insertion cursor to the beginning of the line.

                    If called with an argument of _e_x_t_e_n_d, moves the
                    insertion cursor as in the case of no argument and
                    extends the current selection.

                    The beginning-of-line() action produces calls to
                    the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the beginning-of-line()
                    action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

          clear-selection():
                    Clears the current selection by replacing each
                    character except <<<<RRRReeeettttuuuurrrrnnnn>>>> with a <<<<ssssppppaaaacccceeee>>>>
                    character.

                    The clear-selection() action produces calls to the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE and the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.

          copy-clipboard():
                    If this widget owns the primary selection, this
                    action copies the selection to the clipboard.
                    This action calls the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures, possibly multiple times, for the
                    _C_L_I_P_B_O_A_R_D selection.

          copy-primary():
                    Copies the primary selection to just before the
                    insertion cursor.  This action calls the
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Y
                    selection and the XXXXmmmmCCCCOOOOPPPPYYYY operation.  It calls the
                    selection owner's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,



     Page 30                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    possibly multiple times, for the _P_R_I_M_A_R_Y
                    selection.

                    In addition, the copy-primary() action produces
                    calls to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures
                    with reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, to
                    the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          copy-to():
                    If a secondary selection exists, this action
                    copies the secondary selection to the insertion
                    position of the destination component.  If the
                    primary selection is in the destination widget, it
                    will be deselected. Otherwise, there is no effect
                    on the primary selection.

                    This action calls the destination's
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkprocedures for the _S_E_C_O_N_D_A_R_Y
                    selection and the XXXXmmmmCCCCOOOOPPPPYYYY operation.  The
                    destination's XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures or
                    the destination component itself invokes the
                    selection owner's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
                    possibly multiple times, for the _S_E_C_O_N_D_A_R_Y
                    selection.

                    If no secondary selection exists, this action
                    copies the primary selection to the pointer
                    position.  This action calls the
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Y
                    selection and the XXXXmmmmCCCCOOOOPPPPYYYY operation.  It calls the
                    selection owner's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
                    possibly multiple times, for the _P_R_I_M_A_R_Y
                    selection.

                    In addition, the copy-to() action produces calls
                    to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with
                    reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, to the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If there is no
                    secondary selection, the copy-to() action may
                    produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

          cut-clipboard():
                    If this widget owns the primary selection, this
                    action cuts the selection to the clipboard.  This



     Page 31                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    action calls the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
                    possibly multiple times, for the _C_L_I_P_B_O_A_R_D
                    selection.  If the transfer is successful, this
                    action then calls the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures for the _C_L_I_P_B_O_A_R_D selection and the
                    _D_E_L_E_T_E target.

                    In addition, the cut-clipboard() action produces
                    calls to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures
                    with reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, and
                    the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.

          cut-primary():
                    Cuts the primary selection and pastes it just
                    before the insertion cursor.  This action calls
                    the XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the
                    _P_R_I_M_A_R_Y selection and the XXXXmmmmMMMMOOOOVVVVEEEE operation.  It
                    calls the selection owner's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures, possibly multiple times, for the
                    _P_R_I_M_A_R_Y selection.  If the transfer is successful,
                    this action then calls the selection owner's
                    XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures for the
                    _P_R_I_M_A_R_Yselection and the _D_E_L_E_T_E target.  The cut-
                    primary() action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

                    In addition, the cut-primary() action produces
                    calls to the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures
                    with reason value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR, the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, and the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.

          delete-next-character():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, deletes the
                    character following the insertion cursor.  In add
                    mode, if there is a nonnull selection, the cursor
                    is not disjoint from the selection, and
                    XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
                    selection; otherwise, deletes the character
                    following the insertion cursor.  This may impact
                    the selection.

                    The delete-next-character() action produces calls
                    to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with
                    reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, and the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.



     Page 32                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



          delete-next-word():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, deletes the
                    characters following the insertion cursor to the
                    next space, tab or end-of-line character.  In add
                    mode, if there is a nonnull selection, the cursor
                    is not disjoint from the selection, and
                    XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
                    selection; otherwise, deletes the characters
                    following the insertion cursor to the next space,
                    tab or end-of-line character.  This may impact the
                    selection.  This action may have different
                    behavior in a locale other than the C locale.

                    The delete-next-word() action produces calls to
                    the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, and the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.

          delete-previous-character():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, deletes the
                    character of text immediately preceding the
                    insertion cursor.  In add mode, if there is a
                    nonnull selection, the cursor is not disjoint from
                    the selection, and XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to
                    True, deletes the selection; otherwise, deletes
                    the character of text immediately preceding the
                    insertion cursor.  This may impact the selection.

                    The delete-previous-character() action produces
                    calls to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures
                    with reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          delete-previous-word():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, deletes the
                    characters preceding the insertion cursor to the
                    next space, tab or beginning-of-line character. In
                    add mode, if there is a nonnull selection, the
                    cursor is not disjoint from the selection, and
                    XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
                    selection; otherwise, deletes the characters
                    preceding the insertion cursor to the next space,
                    tab or beginning-of-line character. This may
                    impact the selection. This action may have
                    different behavior in a locale other than the C



     Page 33                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    locale.

                    The delete-previous-word() action produces calls
                    to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with
                    reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          delete-selection():
                    Deletes the current selection.

                    The delete-selection() action produces calls to
                    the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          delete-to-end-of-line():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, deletes the
                    characters following the insertion cursor to the
                    next end of line character.  In add mode, if there
                    is a nonnull selection, the cursor is not disjoint
                    from the selection, and XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to
                    True, deletes the selection; otherwise, deletes
                    the characters following the insertion cursor to
                    the next end of line character.  This may impact
                    the selection.

                    The ddddeeeelllleeeetttteeee----ttttoooo----eeeennnndddd----ooooffff----lllliiiinnnneeee(((()))) action produces calls
                    to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with
                    reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, and the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.

          delete-to-start-of-line():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, deletes the
                    characters preceding the insertion cursor to the
                    previous beginning-of-line character.  In add
                    mode, if there is a nonnull selection, the cursor
                    is not disjoint from the selection, and
                    XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
                    selection; otherwise, deletes the characters
                    preceding the insertion cursor to the previous
                    beginning-of-line character.  This may impact the
                    selection.




     Page 34                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    The delete-to-start-of-line() action produces
                    calls to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures
                    with reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          deselect-all():
                    Deselects the current selection.  The deselect-
                    all() action produces no callbacks.

          end-of-file(_e_x_t_e_n_d):
                    If this action is called with no argument, moves
                    the insertion cursor to the end of the text.

                    If called with an argument of _e_x_t_e_n_d, moves the
                    insertion cursor as in the case of no argument and
                    extends the current selection.

                    The end-of-file() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the end-of-file() action may
                    produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

          end-of-line(_e_x_t_e_n_d):
                    If this action is called with no argument, moves
                    the insertion cursor to the end of the line.  If
                    called with an argument of _e_x_t_e_n_d, moves the
                    insertion cursor as in the case of no argument and
                    extends the current selection.

                    The end-of-line() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the end-of-line() action may
                    produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

          extend-adjust():
                    Selects text from the anchor to the pointer
                    position and deselects text outside that range.
                    Moving the pointer over several lines selects text
                    from the anchor to the end of each line the
                    pointer moves over and up to the pointer position
                    on the current line.

                    The extend-adjust() action produces calls to the



     Page 35                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  The extend-
                    adjust() action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

          extend-end():
                    Moves the insertion cursor to the position of the
                    pointer.  The extend-end() action is used to
                    commit the selection. After this action has been
                    done, process-cancel() will no longer cancel the
                    selection.

                    The extend-end() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  The extend-end()
                    action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

          extend-start():
                    Adjusts the anchor using the balance-beam method.
                    Selects text from the anchor to the pointer
                    position and deselects text outside that range.
                    The extend-start() action may produce no
                    callbacks, however, the extend-start() action may
                    produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

          forward-character(_e_x_t_e_n_d):
                    Moves the insertion cursor one character to the
                    right.  This action may have different behavior in
                    a right-to-left language environment.

                    If called with an argument of _e_x_t_e_n_d, moves the
                    insertion cursor as in the case of no argument and
                    extends the current selection.

                    The forward-character() action produces calls to
                    the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the forward-character()
                    action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

                    In vertical writing, if _X_m_N_e_d_i_t_M_o_d_e is
                    _X_m_S_I_N_G_L_E__L_I_N_E__E_D_I_T and _X_m_N_n_a_v_i_g_a_t_i_o_n_T_y_p_e is
                    _X_m_N_O_N_E, traverses to the widget to the right in
                    the tab group. If _X_m_N_e_d_i_t_M_o_d_e is
                    _X_m_M_U_L_T_I__L_I_N_E__E_D_I_T, moves the insertion cursor to



     Page 36                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    the previous line in the same column.

          forward-paragraph(_e_x_t_e_n_d):
                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, and this
                    action is called with no argument, moves the
                    insertion cursor to the first non-whitespace
                    character following the next blank line.  If the
                    insertion cursor is already at the beginning of a
                    paragraph, moves the insertion cursor to the
                    beginning of the next paragraph.

                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and this
                    action is called with an argument of _e_x_t_e_n_d, moves
                    the insertion cursor as in the case of no argument
                    and extends the current selection.

                    The forward-paragraph() action produces calls to
                    the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the forward-paragraph()
                    action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

          forward-word(_e_x_t_e_n_d):
                    If this action is called with no argument, moves
                    the insertion cursor to the first whitespace
                    character or end-of-line following the next non-
                    whitespace character.  If the insertion cursor is
                    already at the end of a word, moves the insertion
                    cursor to the end of the next word.  This action
                    may have different behavior in a locale other than
                    the C locale.

                    If called with an argument of _e_x_t_e_n_d, moves the
                    insertion cursor as in the case of no argument and
                    extends the current selection.

                    The forward-word() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the forward-word() action may
                    produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

          grab-focus():
                    This key binding performs the action defined in
                    the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyy, depending on the number of
                    multiple mouse clicks.  The default selection
                    array ordering is one click to move the insertion
                    cursor to the pointer position, two clicks to



     Page 37                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    select a word, three clicks to select a line of
                    text, and four clicks to select all text.  A
                    single click also deselects any selected text and
                    sets the anchor at the pointer position.  This
                    action may have different behavior in a locale
                    other than the C locale.

                    The grab-focus() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          Help():   Calls the callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk if any
                    exist.  If there are no help callbacks for this
                    widget, this action calls the help callbacks for
                    the nearest ancestor that has them.

          insert-string(_s_t_r_i_n_g)))):
                    If XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is True and the cursor is not
                    disjoint from the current selection, deletes the
                    entire selection.  Inserts _s_t_r_i_n_g before the
                    insertion cursor.

                    The insert-string() action produces calls to the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  Note that, in
                    the case of an empty string, no callbacks will be
                    called, since no modification will have been done.
                    However, if the insertion position is inside the
                    current selection, iiiinnnnsssseeeerrrrtttt----ssssttttrrrriiiinnnngggg with an empty
                    string will cause the selection to be deselected,
                    and the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures to be
                    called with reason value
                    XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR,
                    XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, and XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.

          key-select(_r_i_g_h_t|_l_e_f_t):
                    If called with an argument of _r_i_g_h_t, moves the
                    insertion cursor one character to the right and
                    extends the current selection.  If called with an
                    argument of _l_e_f_t, moves the insertion cursor one
                    character to the left and extends the current
                    selection.  If called with no argument, extends
                    the current selection.

                    Note that after a kkkkeeeeyyyy----sssseeeelllleeeecccctttt action, the selection
                    will still begin at the original anchor, and will
                    extend to the position indicated in the action
                    call. If this new position is on the opposite side



     Page 38                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    of the selection anchor from the previous
                    selection boundary, the original selection will be
                    deselected.

                    The key-select() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  The key-select()
                    action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

                    In vertical writing, if called with the argument
                    lllleeeefffftttt, and if _X_m_N_e_d_i_t_M_o_d_e is _X_m_M_U_L_T_I__L_I_N_E__E_D_I_T,
                    moves the insertion cursor to the next line in the
                    same column.  In vertical writing, if called with
                    the argument rrrriiiigggghhhhtttt, and if _X_m_N_e_d_i_t_M_o_d_e is
                    _X_m_M_U_L_T_I__L_I_N_E__E_D_I_T, moves the insertion cursor to
                    the previous line in the same column.)

          kill-next-character():
                    In normal mode, if there is a nonnull selection,
                    kills the selection; otherwise, kills the
                    character following the insertion cursor and
                    stores the character in the cut buffer.  In add
                    mode, if there is a nonnull selection, the cursor
                    is not disjoint from the selection, and
                    XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
                    selection; otherwise, kills the character
                    following the insertion cursor and stores the
                    character in the cut buffer.  This may impact the
                    selection.

                    The killed text is stored in _C_U_T__B_U_F_F_E_R_0.

                    The kill-next-character() action produces calls to
                    the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          kill-next-word():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, kills the
                    characters following the insertion cursor to the
                    next space, tab or end-of-line character, and
                    stores the characters in the cut buffer. In add
                    mode, if there is a nonnull selection, the cursor
                    is not disjoint from the selection, and
                    XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
                    selection; otherwise, kills the characters



     Page 39                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    following the insertion cursor to the next space,
                    tab or end-of-line character, and stores the
                    characters in the cut buffer. This may impact the
                    selection. This action may have different behavior
                    in a locale other than the C locale.

                    The killed text is stored in _C_U_T__B_U_F_F_E_R_0.

                    The kill-next-word() action produces calls to the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          kill-previous-character():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, kills the
                    character immediately preceding the insertion
                    cursor and stores the character in the cut buffer.
                    In add mode, if there is a nonnull selection, the
                    cursor is not disjoint from the selection, and
                    XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
                    selection; otherwise, kills the character
                    immediately preceding the insertion cursor and
                    stores the character in the cut buffer.  This may
                    impact the selection.

                    The killed text is stored in _C_U_T__B_U_F_F_E_R_0.

                    The kill-previous-character() action produces
                    calls to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures
                    with reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          kill-previous-word():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, kills the
                    characters preceding the insertion cursor up to
                    the next space, tab or beginning-of-line
                    character, and stores the characters in the cut
                    buffer. In add mode, if there is a nonnull
                    selection, the cursor is not disjoint from the
                    selection, and XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True,
                    deletes the selection; otherwise, kills the
                    characters preceding the insertion cursor up to
                    the next space, tab or beginning-of-line
                    character, and stores the characters in the cut



     Page 40                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    buffer. This may impact the selection. This action
                    may have different behavior in a locale other than
                    the C locale.

                    The killed text is stored in _C_U_T__B_U_F_F_E_R_0.

                    The kill-previous-word() action produces calls to
                    the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          kill-selection():
                    Kills the currently selected text and stores the
                    text in the cut buffer.

                    The killed text is stored in _C_U_T__B_U_F_F_E_R_0.

                    The kill-selection() action produces calls to the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          kill-to-end-of-line():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, kills the
                    characters following the insertion cursor to the
                    next end-of-line character and stores the
                    characters in the cut buffer.  In add mode, if
                    there is a nonnull selection, the cursor is not
                    disjoint from the selection, and XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee
                    is set to True, deletes the selection; otherwise,
                    kills the characters following the insertion
                    cursor to the next end of line character and
                    stores the characters in the cut buffer.  This may
                    impact the selection.

                    The killed text is stored in _C_U_T__B_U_F_F_E_R_0.

                    The kill-to-end-of-line() action produces calls to
                    the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, and the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.  In the case where there
                    is a non-null selection to be deleted, this action
                    may also produce calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason



     Page 41                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          kill-to-start-of-line():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, kills the
                    characters preceding the insertion cursor to the
                    next beginning-of-line character and stores the
                    characters in the cut buffer.  In add mode, if
                    there is a nonnull selection, the cursor is not
                    disjoint from the selection, and XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee
                    is set to True, deletes the selection; otherwise,
                    kills the characters preceding the insertion
                    cursor to the next beginning-of-line character and
                    stores the characters in the cut buffer.  This may
                    impact the selection.

                    The killed text is stored in _C_U_T__B_U_F_F_E_R_0.

                    The kill-to-start-of-line() action produces calls
                    to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with
                    reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          link-primary():
                    Places a link to the primary selection just before
                    the insertion cursor.  This action calls the
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Y
                    selection and the XXXXmmmmLLLLIIIINNNNKKKK operation.  The Text
                    widget itself performs no transfers; the
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures are responsible
                    for inserting the link to the primary selection
                    and for taking any related actions.

          link-to():
                    If a secondary selection exists, this action
                    places a link to the secondary selection at the
                    insertion position of the destination component.
                    This action calls the destination's
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkprocedures for the _S_E_C_O_N_D_A_R_Y
                    selection and the XXXXmmmmLLLLIIIINNNNKKKK operation.

                    If no secondary selection exists, this action
                    places a link to the primary selection at the
                    pointer position.  This action calls the
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Y
                    selection and the XXXXmmmmLLLLIIIINNNNKKKK operation.

                    The Text widget itself performs no transfers; the
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures are responsible



     Page 42                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    for inserting the link to the primary or secondary
                    selection and for taking any related actions.

          move-destination():
                    Moves the insertion cursor to the pointer position
                    without changing any existing current selection.
                    If there is a current selection, sets the widget
                    as the destination widget.  This also moves the
                    widget focus to match the insertion cursor.

                    The move-destination() action produces calls to
                    the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          move-to():
                    If a secondary selection exists, this action moves
                    the secondary selection to the insertion position
                    of the destination component.  If the secondary
                    selection is in the destination widget, and the
                    secondary selection and the primary selection
                    overlap, the result is undefined.  This action
                    calls the destination's
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkprocedures for the _S_E_C_O_N_D_A_R_Y
                    selection and the XXXXmmmmMMMMOOOOVVVVEEEE operation.  The
                    destination's XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures or
                    the destination component itself invokes the
                    selection owner's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
                    possibly multiple times, for the _S_E_C_O_N_D_A_R_Y
                    selection.  If the transfer is successful, this
                    action then calls the selection owner's
                    XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures for the
                    _S_E_C_O_N_D_A_R_Yselection and the _D_E_L_E_T_E target.

                    If no secondary selection exists, this action
                    moves the primary selection to the pointer
                    position.  This action calls the
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Y
                    selection and the XXXXmmmmMMMMOOOOVVVVEEEE operation.  It calls the
                    selection owner's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
                    possibly multiple times, for the _P_R_I_M_A_R_Y
                    selection.  If the transfer is successful, this
                    action then calls the selection owner's
                    XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures for the
                    _P_R_I_M_A_R_Yselection and the _D_E_L_E_T_E target.

                    The move-to() action produces calls to the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If there is no



     Page 43                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    secondary selection, the move-to() action may
                    produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

          newline():
                    If XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is True and the cursor is not
                    disjoint from the current selection, deletes the
                    entire selection.  Inserts a newline before the
                    insertion cursor.

                    The newline() action produces calls to the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          newline-and-backup():
                    If XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is True and the cursor is not
                    disjoint from the current selection, deletes the
                    entire selection.  Inserts a newline just before
                    the insertion cursor and repositions the insertion
                    cursor to the end of the line before the newline.

                    The newline-and-backup() action produces calls to
                    the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, and the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.

          newline-and-indent():
                    If XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is True and the cursor is not
                    disjoint from the current selection, deletes the
                    entire selection.  Inserts a newline and then the
                    same number of whitespace characters as at the
                    beginning of the previous line.

                    The newline-and-indent() action produces calls to
                    the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          next-line():
                    Moves the insertion cursor to the next line.

                    The next-line() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason



     Page 44                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          next-page(_e_x_t_e_n_d):
                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and this
                    action is called with no argument, moves the
                    insertion cursor forward one page.

                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and this
                    action is called with an argument of _e_x_t_e_n_d, it
                    moves the insertion cursor as in the case of no
                    argument and extends the current selection.

                    The next-page() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the next-page() action may
                    produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

                    In vertical writing, scrolls the viewing window
                    down one page of text.

          next-tab-group():
                    Traverses to the next tab group.

                    The next-tab-group() action produces no callbacks,
                    unless it results in the widget losing focus, in
                    which case, the XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk procedures
                    are called with reason value XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS.

          page-left(_e_x_t_e_n_d):
                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and this
                    action is called with no argument, moves the
                    insertion cursor back one page.

                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and this
                    action is called with an argument of _e_x_t_e_n_d, it
                    moves the insertion cursor as in the case of no
                    argument and extends the current selection.

                    The page-left() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the page-left() action may
                    produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

          page-right(_e_x_t_e_n_d):
                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and this
                    action is called with no argument, moves the



     Page 45                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    insertion cursor forward one page.

                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and this
                    action is called with an argument of _e_x_t_e_n_d, it
                    moves the insertion cursor as in the case of no
                    argument and extends the current selection.

                    The page-right() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the page-right() action may
                    produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

          paste-clipboard():
                    Pastes the contents of the clipboard before the
                    insertion cursor.  This action calls the
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the
                    _C_L_I_P_B_O_A_R_D selection and the XXXXmmmmCCCCOOOOPPPPYYYY operation.

                    The paste-clipboard() action produces calls to the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          prev-tab-group():
                    Traverses to the previous tab group.

                    The prev-tab-group() action produces no callbacks,
                    unless it results in the widget losing focus, in
                    which case, the XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk procedures
                    are called with reason value XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS.

          previous-line():
                    Moves the insertion cursor to the previous line.

                    The previous-line() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          previous-page(_e_x_t_e_n_d):
                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and this
                    action is called with no argument, moves the
                    insertion cursor back one page.

                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and this
                    action is called with an argument of _e_x_t_e_n_d, it
                    moves the insertion cursor as in the case of no



     Page 46                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    argument and extends the current selection.

                    The previous-page() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the previous-page() action
                    may produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

                    In vertical writing, if called without an
                    argument, scrolls the viewing window up one page
                    of text.

          process-bdrag()
                    If the pointer is within the selection, this
                    action starts a drag operation for the selection.
                    This action sets the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc of the
                    DragContext to a function that calls the
                    XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures, possibly multiple
                    times, for the ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP selection.

                    If no selection exists or the pointer is outside
                    the selection, this action prepares to start a
                    secondary selection at the pointer position.

               NNNNooootttteeee::::

                         Note that when dragging a secondary selection
                         to a different widget, focus will shift
                         momentarily to the second widget, and then
                         back to the original widget. This will
                         generate callbacks to the
                         XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk procedures as focus is
                         lost (by each widget) as well as callbacks to
                         the XXXXmmmmNNNNffffooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk procedures as focus is
                         regained.

          process-cancel():
                    Cancels the current extend-adjust(), secondary-
                    adjust()or process-bdrag()operation and leaves the
                    selection state as it was before the operation;
                    otherwise, and if the parent is a manager, passes
                    the event to the parent.

          process-down(_e_x_t_e_n_d):
                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, and
                    XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee is XXXXmmmmNNNNOOOONNNNEEEE, traverses to the
                    widget below the current one in the tab group.

                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and this
                    action is called with an argument of _e_x_t_e_n_d, moves



     Page 47                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    the insertion cursor as in the case of no argument
                    and extends the current selection.

                    In this case, the action will produce the
                    XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkkcallbacks with reason value
                    XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS.

                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, moves the
                    insertion cursor down one line.

                    The process-down() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

                    In vertical writing, moves the insertion cursor
                    one character down.

          process-home():
                    Moves the insertion cursor to the beginning of the
                    line.

                    The process-home() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          process-return():
                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, calls the
                    callbacks for XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk, and if the
                    parent is a manager, passes the event to the
                    parent.  If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT,
                    inserts a newline.

                    The process-return() action during single-line
                    edit produces calls to the XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures with reason value XXXXmmmmCCCCRRRR____AAAACCCCTTTTIIIIVVVVAAAATTTTEEEE. During
                    multi-line editing, the process-return() action
                    produces calls to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures with reason value
                    XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          process-shift-down():
                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, moves the
                    insertion cursor down one line and selects. If
                    XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, this action
                    behaves like process-up() in XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT.
                    Refer to the process-up() action.

                    The process-shift-down() action produces calls to



     Page 48                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

                    In vertical writing, if called with the argument
                    uuuupppp, moves the insertion cursor one character up
                    and extends the current selection. If called with
                    the argument ddddoooowwwwnnnn, moves the insertion cursor one
                    character down and extends the current selection.

          process-shift-up():
                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, moves the
                    insertion cursor up one line and selects. If
                    XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, this action
                    behaves like process-up() in XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT.
                    Refer to the process-up() action.

                    The process-shift-up() action produces calls to
                    the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

                    In vertical writing, if called with the argument
                    uuuupppp, moves the insertion cursor one character up
                    and extends the current selection. If called with
                    the argument ddddoooowwwwnnnn, moves the insertion cursor one
                    character down and extends the current selection.

          process-tab(_P_r_e_v|_N_e_x_t):
                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, traverses to
                    the next tab group if the direction argument is
                    NNNNeeeexxxxtttt, or to the previous tab group if the
                    direction is PPPPrrrreeeevvvv. If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is
                    XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, and the direction is NNNNeeeexxxxtttt, the
                    action inserts a tab. The PPPPrrrreeeevvvv direction has no
                    effect with XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT.  In the Text
                    widget, there is a preset tab stop at every eighth
                    columns.

                    The process-tab() action under multi-line editing
                    produces calls to the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures with reason value
                    XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR. Under single-line
                    editing, the action produces no callbacks, unless
                    it results in the widget losing focus, in which
                    case, the XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk procedures are
                    called with reason value XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS.

          process-up(_e_x_t_e_n_d):
                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and
                    XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee is XXXXmmmmNNNNOOOONNNNEEEE, traverses to the
                    widget above the current one in the tab group.

                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, moves the



     Page 49                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    insertion cursor up one line.

                    If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and this
                    action is called with an argument of _e_x_t_e_n_d, moves
                    the insertion cursor as in the case of no argument
                    and extends the current selection.

                    The process-up() action under multi-line editing
                    produces calls to the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures with reason value
                    XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR. Under single-line
                    editing, the action produces no callbacks unless
                    it results in the widget losing focus, in which
                    case, the XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk procedures are
                    called with reason value XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS.

                    In vertical writing, moves the insertion cursor
                    one character up.

          redraw-display():
                    Redraws the contents of the text window.

                    The redraw-display() action produces no callbacks.

          scroll-cursor-vertically(_p_e_r_c_e_n_t_a_g_e)))):
                    Scrolls the line containing the insertion cursor
                    vertically to an intermediate position in the
                    visible window based on an input percentage. A
                    value of 0 indicates the top of the window; a
                    value of 100, the bottom of the window. If this
                    action is called with no argument, the line
                    containing the insertion cursor is scrolled
                    vertically to a new position designated by the _y
                    position of the event passed to the routine.

                    The ssssccccrrrroooollllllll----ccccuuuurrrrssssoooorrrr----vvvveeeerrrrttttiiiiccccaaaallllllllyyyy action produces no
                    callbacks.

          scroll-one-line-down():
                    Scrolls the text area down one line.

                    The scroll-one-line-down() action produces no
                    callbacks.

          scroll-one-line-up():
                    Scrolls the text area up one line.

                    The scroll-one-line-up() action produces no
                    callbacks.

          secondary-adjust():
                    Extends the secondary selection to the pointer



     Page 50                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    position.

                    The secondary-adjust() action produces no
                    callbacks.

          secondary-notify():
                    Copies the secondary selection to the insertion
                    cursor of the destination widget.

                    The secondary-notify() action produces calls to
                    the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, and the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.

          secondary-start():
                    Marks the beginning of a secondary selection.

                    The secondary-start() action produces no
                    callbacks.

          select-adjust():
                    Moves the current selection.  The amount of text
                    selected depends on the number of mouse clicks, as
                    specified by the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyy resource.

                    The select-adjust() action may produce no
                    callbacks, however, it may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

          select-all():
                    Selects all text.

                    The select-all() action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.

          select-end():
                    Moves the current selection.  The amount of text
                    selected depends on the number of mouse clicks, as
                    specified by the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyy resource.

                    The select-end() action produces no callbacks.

          select-start():
                    Marks the beginning of a new selection region.

                    The select-start() action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.

          self-insert():
                    If XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is True and the cursor is not



     Page 51                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    disjoint from the current selection, deletes the
                    entire selection.  Inserts the character
                    associated with the key pressed at the insertion
                    cursor.

                    The self-insert() action produces calls to the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          set-anchor():
                    Resets the anchor point for extended selections.
                    Resets the destination of secondary selection
                    actions.

                    The set-anchor() action produces no callbacks.

          set-insertion-point():
                    Sets the insertion position to the position of the
                    mouse pointer.

                    The set-insertion-point() action produces calls to
                    the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR. Note that if the
                    mouse pointer is already over the position of the
                    insertion cursor, the cursor will not be moved,
                    and no callbacks will be produced.

          set-selection-hint():
                    Sets the text source and location of the current
                    selection.

                    The set-selection-hint() action produces no
                    callbacks.

          toggle-add-mode():
                    Toggles the state of Add Mode.

                    The toggle-add-mode() action produces no
                    callbacks.

          toggle-overstrike():
                    Toggles the state of the text insertion mode. By
                    default, characters typed into the Text widget are
                    inserted at the position of the insertion cursor.
                    In overstrike mode, characters entered into the
                    Text widget replace the characters that directly
                    follow the insertion cursor.  In overstrike mode,
                    when the end of a line is reached, characters are



     Page 52                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



                    appended to the end of the line.

                    The following traversal actions generate no
                    callbacks unless they result in the loss of focus
                    by the widget in question, as when
                    XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee is XXXXmmmmNNNNOOOONNNNEEEE. In this case, they
                    produce calls to the XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures, with reason value XXXXmmmmCCCCRRRR____FFFFOOOOCCCCUUUUSSSS____MMMMOOOOVVVVEEEEDDDD.

          traverse-home():
                    Traverses to the first widget in the tab group.

          traverse-next():
                    Traverses to the next widget in the tab group.

          traverse-prev():
                    Traverses to the previous widget in the tab group.

          unkill(): Restores last killed text to the position of the
                    insertion cursor (or whatever is currently in the
                    _C_U_T__B_U_F_F_E_R_0).  The inserted text appears before
                    the insertion cursor.

                    The unkill() action produces calls to the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

        AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr
          This widget has the following additional behavior:

          <<<<FFFFooooccccuuuussssIIIInnnn>>>>:
                    Draws the insertion cursor as solid and starts
                    blinking the cursor.

          <<<<FFFFooooccccuuuussssOOOOuuuutttt>>>>:
                    Displays the insertion cursor as a stippled I-beam
                    unless it is the destination widget and stops the
                    cursor from blinking.

        VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
          The bindings for virtual keys are vendor specific.  For
          information about bindings for virtual buttons and keys, see
          VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3).

     RRRREEEELLLLAAAATTTTEEEEDDDD
          CCCCoooorrrreeee(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSccccrrrroooolllllllleeeeddddTTTTeeeexxxxtttt(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeTTTTeeeexxxxtttt(3),
          XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt(3), XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttAAAAppppppppeeeennnnddddEEEEnnnnttttrrrryyyy(3), XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee(3),
          XXXXmmmmTTTTeeeexxxxttttCCCClllleeeeaaaarrrrSSSSeeeelllleeeeccccttttiiiioooonnnn(3), XXXXmmmmTTTTeeeexxxxttttCCCCooooppppyyyy(3), XXXXmmmmTTTTeeeexxxxttttCCCCooooppppyyyyLLLLiiiinnnnkkkk(3),



     Page 53                                         (printed 10/3/02)






     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))



          XXXXmmmmTTTTeeeexxxxttttCCCCuuuutttt(3), XXXXmmmmTTTTeeeexxxxttttEEEEnnnnaaaabbbblllleeeeRRRReeeeddddiiiissssppppllllaaaayyyy(3),
          XXXXmmmmTTTTeeeexxxxttttDDDDiiiissssaaaabbbblllleeeeRRRReeeeddddiiiissssppppllllaaaayyyy(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiinnnnddddSSSSttttrrrriiiinnnngggg(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiinnnnddddSSSSttttrrrriiiinnnnggggWWWWccccssss(3),
          XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttBBBBaaaasssseeeelllliiiinnnneeee(3), XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttEEEEddddiiiittttaaaabbbblllleeee(3),
          XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttIIIInnnnsssseeeerrrrttttiiiioooonnnnPPPPoooossssiiiittttiiiioooonnnn(3), XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttLLLLaaaassssttttPPPPoooossssiiiittttiiiioooonnnn(3),
          XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttMMMMaaaaxxxxLLLLeeeennnnggggtttthhhh(3), XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnn(3),
          XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnnWWWWccccssss(3), XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnnPPPPoooossssiiiittttiiiioooonnnn(3),
          XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttSSSSoooouuuurrrrcccceeee(3), XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttSSSSttttrrrriiiinnnngggg(3),
          XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttSSSSttttrrrriiiinnnnggggWWWWccccssss(3), XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttSSSSuuuubbbbssssttttrrrriiiinnnngggg(3),
          XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttSSSSuuuubbbbssssttttrrrriiiinnnnggggWWWWccccssss(3), XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttTTTTooooppppCCCChhhhaaaarrrraaaacccctttteeeerrrr(3),
          XXXXmmmmTTTTeeeexxxxttttIIIInnnnsssseeeerrrrtttt(3), XXXXmmmmTTTTeeeexxxxttttIIIInnnnsssseeeerrrrttttWWWWccccssss(3), XXXXmmmmTTTTeeeexxxxttttPPPPaaaasssstttteeee(3),
          XXXXmmmmTTTTeeeexxxxttttPPPPaaaasssstttteeeeLLLLiiiinnnnkkkk(3), XXXXmmmmTTTTeeeexxxxttttPPPPoooossssTTTTooooXXXXYYYY(3), XXXXmmmmTTTTeeeexxxxttttPPPPoooossssiiiittttiiiioooonnnn(3),
          XXXXmmmmTTTTeeeexxxxttttRRRReeeemmmmoooovvvveeee(3), XXXXmmmmTTTTeeeexxxxttttRRRReeeeppppllllaaaacccceeee(3), XXXXmmmmTTTTeeeexxxxttttRRRReeeeppppllllaaaacccceeeeWWWWccccssss(3),
          XXXXmmmmTTTTeeeexxxxttttSSSSccccrrrroooollllllll(3), XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttAAAAddddddddMMMMooooddddeeee(3), XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttEEEEddddiiiittttaaaabbbblllleeee(3),
          XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttHHHHiiiigggghhhhlllliiiigggghhhhtttt(3), XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttIIIInnnnsssseeeerrrrttttiiiioooonnnnPPPPoooossssiiiittttiiiioooonnnn(3),
          XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttMMMMaaaaxxxxLLLLeeeennnnggggtttthhhh(3), XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnn(3),
          XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttSSSSoooouuuurrrrcccceeee(3), XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttSSSSttttrrrriiiinnnngggg(3),
          XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttSSSSttttrrrriiiinnnnggggWWWWccccssss(3), XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttTTTTooooppppCCCChhhhaaaarrrraaaacccctttteeeerrrr(3),
          XXXXmmmmTTTTeeeexxxxttttSSSShhhhoooowwwwPPPPoooossssiiiittttiiiioooonnnn(3), and XXXXmmmmTTTTeeeexxxxttttXXXXYYYYTTTTooooPPPPoooossss(3).




































     Page 54                                         (printed 10/3/02)